home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / art&graf.ix / art-0056 / viewgif8 / viewgif.doc next >
Text File  |  1997-04-16  |  13KB  |  319 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                             VIEWGIF (Version 0.8) 
  8.  
  9.                         Copyright by Craig S. Buchanan 
  10.          
  11.                                 SHAREWARE 
  12.  
  13. This program is copyrighted software. This program and its documentation may
  14. be freely copied and shared with others, as long as no charge is made and the
  15. program and documentation are unaltered. 
  16.  
  17. If you use this program please support it by sending $15 and any suggestions
  18. for improvements to the address listed below. Your support will ensure that
  19. improvements are made. 
  20.  
  21.     4-319 Mackay St. 
  22.     Ottawa, Ont. 
  23.     K1M 2B7 
  24.  
  25. Contents: 
  26.         What's New? 
  27.     1.  Introduction 
  28.     2.  Function Overview 
  29.     3.  Known Problems 
  30.     4.  Enhancements Under Consideration 
  31.     5.  Program History 
  32.  
  33.  
  34. WHAT'S NEW? - Changes in VIEWGIF 0.8
  35.  
  36.     1.  All "translate..." conversions now work. 
  37.             This includes CP8, AIM, and SPU. 256 colour GIF images can now be
  38.             converted to 256 gray scale AIM images for image processing using
  39.             the "Atari Image Manager". These gray scale images can also be
  40.             stored and viewed using the compressed CP8 format.
  41.     2.  Load CP8 option added. 
  42.     3.  Improved monochrome support.
  43.             A dispersed dot dither mode has been added. While the dispersed
  44.             dot dither is much slower than the ordered dither the results are
  45.             much better. The dispersed dot dither has two modes, scaled and
  46.             histogram equalization.
  47.     4.  Now supports OVERSCAN fully.
  48.             The OVERSCAN modification allows an ordinary Atari ST to display
  49.             an increased resolution screen in all three ST modes. When
  50.             activated OVERSCAN allows an entire Degas picture to be displayed
  51.             INSIDE A WINDOW. Viewgif looks great with OVERSCAN displaying full
  52.             320x200, 640x200 and 640x400 images inside GEM windows. Overscan
  53.             requires a very simple and inexpensive modification to your ST.  
  54.     5.  LOW and MED resolution option to display GIF colour images as GRAY
  55.         scale images.
  56.             Displaying a 256 colour GIF image on the ST's 16 or 4 colour
  57.             display involves a lot of compromise in the image quality.
  58.             Converting the image to a gray scale image and using an
  59.             intelligent dithering routine often results in much more image
  60.             detail being preserved. This can be most clearly seen in Medium
  61.  
  62.  
  63.  
  64.  
  65.  
  66.             Resolution where the gray scale images are clearly superior to the
  67.             colour images.
  68.  
  69.  
  70.  
  71. 1. INTRODUCTION 
  72.  
  73.     So what are GIF files and why should I be interested? GIF files are
  74. computer graphic images stored in a compressed, hardware independent manner.
  75. The hardware independent format makes it a standard for moving images between
  76. different computers. 
  77.  
  78.     VIEWGIF allows your ST to show graphics created on a PC, an Amiga,
  79. whatever. Even if the original image has more colours or pixels than the ST
  80. can display. It also allows you to convert your Atari ST images into GIF
  81. format for exchange with other systems.  
  82.  
  83.     VIEWGIF is GEM based and operates in all three resolutions. Images are
  84. displayed in scrollable windows. Once an image is loaded it can be saved in
  85. NEO or Degas Format. The image can also be cropped and shrunk to fit the ST
  86. screen. VIEWGIF also allows a GIF image to be directly transformed into AIM
  87. and Spectrum 512 pictures. This allows the 512 colour Spectrum mode to be used
  88. to display 256 colour VGA images. 
  89.  
  90.  
  91. 2. FUNCTION OVERVIEW 
  92.  
  93.     Most menu items have keyboard equivalents which are noted at the end of
  94. each menu item. A caret (^) denotes a control key while a small triangle
  95. denotes an alternate key. The equivalents are listed with their corresponding
  96. functions in the list below. 
  97.  
  98. 2.1  FILE - menu 
  99.  
  100.     GIF INFO: (ALT I) 
  101.         Given a GIF file it displays the image attributes including dimension,
  102.         number of colours, size of colour palette, etc. It also tries to
  103.         determine the image's original video format. 
  104.  
  105.     LOAD GIF/NEO/DEGAS/MAC/CP8: (ALT G, ALT N, ALT D, ALT M, ALT P) 
  106.         Loads an image of the particular file type. 
  107.  
  108.         The GIF mode reads in the GIF file and then translates it to the
  109.         current ST format according to the options set in the MODE menu. The
  110.         two modes are COLOUR and GRAY. (See discussion of MODE.) 
  111.  
  112.         The DEGAS mode currently reads uncompressed DEGAS only.
  113.  
  114.         The MAC mode will read and translate into the current resolution any
  115.         MacPaint image. Mac StartUpScreens will not read properly. 
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.         The CP8 mode always uses the dispersed dot dither to translate the
  124.         image into the current ST format regardless of the MODE options COLOUR
  125.         and GRAY. (See CP8 discussion in TRANSFORM.) The dispersed dot dither
  126.         MODE options HISTO and SCALED are used. (See MODE discussion.)
  127.  
  128.         Each image is displayed in its own window and each window has its own
  129.         colour palette. The top window's colour palette is always used. The
  130.         original image dimensions are maintained. The CLIP and SHRINK
  131.         functions can be used to reduce the image size. The title bar of each
  132.         window contains the image filename and the information bar contains a
  133.         description of the image colours along with the dimensions of the
  134.         image. If the image is in colour then the information bar contains
  135.         [a:b] where 'a' is the number of colours in the original image and 'b'
  136.         is the number of Atari ST colours. If the image is displayed in gray
  137.         scale then the information bar contains [a:b] where 'a' is the number
  138.         of colours in the original image and 'b' is the number of grays in the
  139.         image.
  140.  
  141.     SAVE NEO/DEGAS/GIF: (CTRL N, CTRL G, CTRL G)  
  142.         Saves the current image (top window) in the particular file type. The
  143.         DEGAS mode writes only uncompressed DEGAS.  
  144.  
  145.         Save NEO/DEGAS shows the image to be saved in a full screen view. This
  146.         allows the clipping of the current window to be checked before saving.
  147.         When overscan or another non native ST video mode is used this full
  148.         screen view is not displayed. (It is presumed that in these cases a
  149.         full NEO or DEGAS picture will fit inside a window making the preview
  150.         unnecessary.)
  151.  
  152.     CLOSE: (ALT C) 
  153.         Closes the Top Window. 
  154.  
  155.     QUIT:  (ALT Q or CTRL C) 
  156.         Exits the program. 
  157.  
  158. 2.2 EDIT - Menu.
  159.  
  160.     CLIP:  
  161.         Crops the current image at one of the four window boundaries. Simply
  162.         size and scroll the window to the correct place, select CLIP, and then
  163.         select the clipping corner. 
  164.  
  165.     SHRINK: (ALT S) 
  166.         Halves the image size using one of three methods. LINEAR works best on
  167.         256 colour images while the two STAGGERED modes work best on 4 and 16
  168.         colour images where dithering/patterning has been used to simulate
  169.         more colours. Many EGA (an IBM graphic mode) images use a checkerboard
  170.         pattern to simulate more than 16 colours. A linear shrink of the image
  171.         will produce only one colour in the checkerboard, the staggered modes
  172.         are designed to preserve the colour dither.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.     COLOURS:  
  181.         Allows the Colour Palette of the Top Window to be edited. The modified
  182.         colours can be SAVED, kept with the window, USED, not stored with the
  183.         image but left the current colours, and CANCELLED. 
  184.  
  185.     DESKTOP: (Undo) 
  186.         Returns the colour palette to your desktop colours. To return to an
  187.         image's palette use COLOURS or make another picture the active (top)
  188.         window. 
  189.   
  190.     TRANSFORM ...: 
  191.         Allows a GIF image to be converted to either AIM, CP8 or SPU (Spectrum
  192.         uncompressed) without first being converted to screen format. This
  193.         allows the maximum of image data to be maintained.
  194.  
  195.         When converting an image to SPU that is larger than 320x199 the top
  196.         left hand corner of the image will be used.
  197.  
  198.         When converting to an AIM image both an .IM and a .HD file are
  199.         produced.
  200.  
  201.         When converting an image to CP8 a false gray routine will be used if
  202.         the image contains less than 256 colours. The false gray routine tries
  203.         to ensure that two colours with the same gray value are encoded with
  204.         slightly different gray values. The false gray routine is used to
  205.         prevent 16 colour images from becoming 4 gray level images.
  206.  
  207.         Why translate to CP8? The CP8 format is designed for 8 bit gray scale
  208.         images. It is a hardware independent, compressed format like GIF but
  209.         unlike GIF it can be compressed in very little time and decompressed
  210.         almost instantly. The CP8 format trades a decrease in compression
  211.         performance for a large increase in decompression speed. The CP8
  212.         format also allows the decompression routine to detect corrupted data
  213.         while the GIF format does not. (This is a small point as the picture
  214.         will show any file corruption dramatically.)
  215.  
  216.  
  217. 2.3 MODE - Menu.
  218.  
  219.     COLOUR:
  220.         When COLOUR is selected LOAD GIF translates the GIF file into a colour
  221.         picture. This mode is obviously unavailable in monochrome mode.
  222.  
  223.     GRAY:
  224.         When GRAY is selected LOAD GIF translates the GIF file into a gray
  225.         scale picture. This mode is preselected in monochrome mode.
  226.  
  227.     ORDERED:
  228.         Only available if GRAY is selected, only available in monochrome mode.
  229.         When selected an ordered dither is used to convert the gray scale
  230.         image into monochrome. (This is the monochrome routine found in older
  231.         versions of VIEWGIF.)
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.     DISPERSED:
  239.         This mode is preselected when GRAY is chosen. When selected a
  240.         dispersed dot dither is used to convert the gray scale image to 2, 4,
  241.         or 8 shades of gray depending on the current resolution.
  242.  
  243.     HISTO:
  244.         When HISTO is selected all DISPERSED gray dithers use histogram
  245.         equalization to maximize the contrast of the resultant picture. This
  246.         mode is always available (even when COLOUR is selected) because it is
  247.         always used by LOAD CP8. HISTO alternative is SCALED. HISTO distorts
  248.         the gray scale linearity resulting in an artificial image.
  249.  
  250.     SCALED:
  251.         When SCALED is selected all DISPERSED gray dithers use scaling to
  252.         insure full gray scale coverage in the resultant picture. This mode is
  253.         always available (even when COLOUR is selected) because it is always
  254.         used by LOAD CP8. SCALED alternative is HISTO. SCALE preserves the
  255.         gray scale linearity resulting in a truer image than HISTO.
  256.  
  257. 3. KNOWN SHORTCOMINGS/BUGS 
  258.  
  259.     A.  Full Size Window button does not work properly. 
  260.     B.  Edit colour did not seem to be compatible with QUICK-ST 1.6. 
  261.     C.  Window colours can still go to black on black on some images. This is
  262.         best fixed by remembering the DESKTOP colour menu key equivalent
  263.         (UNDO). 
  264.  
  265.  
  266.  
  267. 4. ENHANCEMENTS UNDER CONSIDERATION 
  268.  
  269.     A.  Support 4096 Colour Mode of STE and Modified ST. 
  270.     B.  Add the following GIF and non-GIF "TRANSLATE..." options:
  271.             translate CP8 to AIM,
  272.             translate AIM to CP8,
  273.             translate GIF to Colour AIM,
  274.             translate CP8 to GIF.
  275.   C.    Add support for 24-bit colour CP8 images.
  276.             This would be a pair of translate options:
  277.                 translate a 24-bit colour image into a 256 colour GIF image,
  278.                 translate 3 CP8 images into a 24-bit CP8 image.
  279.     D.  Add Compressed Degas format load/save. 
  280.     E.  Add Memory Lean GIF read option.
  281.             The Lean option trades reduced memory requirements for a reduction
  282.             in image quality. 
  283.     F.  Add TT video mode support. (640x480x16, 1280x960x2, 320x400x256) 
  284.         (When the TT makes its mass market appearance.)
  285.     G.  Add an AVERAGE option to the SHRINK routines.
  286.             An average routine would allow gray dithered images to be shrunk.
  287.             It would return an error message when given a colour image.
  288.     H.  Add a full screen option.
  289.             This would put the image on the full screen and use the cursor
  290.             keys to scroll the image. (I personally recommend the use of
  291.             OVERSCAN instead.)
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.      
  299.  
  300. 5. PROGRAM HISTORY 
  301.  
  302.     0.6 First SHAREWARE release of VIEWGIF. 
  303.     0.7 Fixed bugs due to differences between TOS 1.2 and TOS 1.1 [(c) 1985]. 
  304.         Low Res now works under TOS 1.1 [(c) 1985]. 
  305.         Neo/Degas save now works under TOS 1.1 [(c) 1985]. 
  306.         NOTE: Viewgif 0.6 worked under TOS 1.1 [(c) 1985] if key commands 
  307.               were used instead of menu items. 
  308.         WHAT'S NEW? - Changes in VIEWGIF 0.7. 
  309.         1. Low Res now works under TOS 1.1. [(c) 1985]. 
  310.         2. Neo/Degas save now works under TOS 1.1 [(c) 1985]. 
  311.         3. Slight rearrangement of menu items. 
  312.         4. Control, Alternate abbreviations changed in menu items. 
  313.  
  314.     0.8 Released February 25, 1990. 
  315.  
  316.  
  317. GIF is a trademark (tm) of Compuserve Inc, an H&R Block Company. 
  318.  
  319.